home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus 1995 #1 / Amiga Plus 1995 #1.iso / animationen / amiflick / amiflick.doc < prev    next >
Text File  |  1994-12-13  |  7KB  |  151 lines
  1.                               AmiFlick v2.02
  2.                         An FLI player for the Amiga
  3.                             ©1993 Garrick Meeker
  4.  
  5.    This program is hereby placed in the public domain.  You may freely
  6. distribute it as long no more than a nominal fee for time and copying costs
  7. is charged.  This document must be included with the program.  I assume
  8. no reponsibilities for the behavior of this program.
  9.    Thanks to Chris Green and Richard Addison for the chunky to planar
  10. routine.
  11.  
  12.    Have you ever wanted to use your Amiga to handle all those zillions
  13. of FLI files for PeeCee's?  Well, now there's AmiFlick.  It can play FLI's
  14. or write them to disk as a bunch of IFF's.  It can also handle the newer
  15. format of FLI's (sometimes called FLC's).
  16.    AmiFlick requires at least AmigaDOS 1.2 (I will probably, but not
  17. definately continue to support 1.2).  AmiFlick also requires
  18. iffparse.library to write files.  This is part of WB2.0, but will run under
  19. 1.2.  However, the only legal way to get it is to buy WB2.0 or a program
  20. that has licensed it (Deluxe Music is one that I know of).  A lot of you
  21. 1.2 and 1.3 users won't be able to write files, and this isn't going to
  22. change.  You should probably consider upgrading, anyway.  Enough said.
  23.  
  24.    A version optimized for the 68030 is included, but the difference
  25. isn't all that noticable.
  26.  
  27. Usage: AmiFlick [-v] [-d<delay>] [-f] [-c] [-h] [-g] [-s] [-l] [-b]
  28.                 [-m<mode>] [-a5] [-a7s] [-a7l] [-n] file [outfile]
  29.  -v         Verbose file information
  30.  -d<delay>  Delay between frames in 1/70s of a second
  31.  -f         Fast mode (requires more memory)
  32.  -c         Color mode (requires AGA)
  33.  -h         HAM mode
  34.  -g         256 shade grey mode (requires AGA)
  35.  -s         Scan file only
  36.  -l         Load file into memory before playing
  37.  -b         Double buffer playback
  38.  -m<mode>   Screen mode to use
  39.  -a5        'outfile' will be ANIM5 (smallest format)
  40.  -a7s       'outfile' will be ANIM7 short-word
  41.  -a7l       'outfile' will be ANIM7 long-word (fastest playback)
  42.  -n         No ANHD in the first frame of ANIM
  43. 16 shade grey mode is the default
  44.    The FLI file may be specified without the '.FLI' or '.FLC'
  45. extension.
  46.    If outfile is specified, a series of 256 color ILBM's are written
  47. in the form outfile.nnn or outfile.nnnnn, depending on how many
  48. frames are in the file.
  49.  
  50.    To write the frames as a bunch of pictures just type:
  51.  
  52. AmiFlick file outfile
  53.  
  54.    Where 'file' is the FLI and outfile is the basename for the 256 color
  55. IFF pictures.
  56.  
  57.    If one of the '-a' options is used, an ANIM file will be created.
  58.  
  59.    By default, AmiFlick saves a ANHD chunk for the timing information in
  60. the first frame of the ANIM file.  This is perfectly legal, but some
  61. programs may get confused by this.  If this is a problem, use the '-n'
  62. option to leave out the ANHD in the first frame.
  63.  
  64.    AmiFlick now saves pictures using the display type selected.  If no
  65. flag is given, the files will be 16 shades of grey.  To save in 256 colors,
  66. use the '-c' flag (AGA is not required when only saving the files).
  67.  
  68.    'AmiFlick -s file' will just display info about the file, like how
  69. many frames there are.
  70.  
  71.    For playback, just type 'AmiFlick file'.  This will give you a 16 shade
  72. grey scale display.  During playback, you can use these keys:
  73.         ESC          Exits the animation.
  74.         Left Arrow   Slows down playback.
  75.         Right Arrow  Speeds up playback.
  76.         Space Bar    Pauses playback or steps forward a frame.
  77.         Return       Resumes playback.
  78.    If the screen is bigger than the display you can autoscroll with the
  79. mouse under 2.0 and greater.  The other display types available are:
  80.         '-g'   256 shade grey scale.  Requires AGA.
  81.         '-c'   Color.  This will display the file without any conversion.
  82.                Also requires AGA.
  83.         '-h'   HAM mode.  In order to speed things up this looks very
  84.            blocky and has a "rainbow" effect on text.  I might improve
  85.            the algorithm in the future.
  86.  
  87.    Some other options:
  88.         '-v'         Verbose information on the file, mainly for debugging.
  89.         '-f'         Use a chunky bitmap in fast RAM.  Uses more memory,
  90.                      but can be much faster.
  91.         '-a5'        Create ANIM5 file instead of separate pictures.  This
  92.                      is the most common and smallest ANIM format.
  93.         '-a7s'       Create ANIM7 short-word file.  Larger files, but
  94.                      faster playback on accelerated machines.  Not many
  95.                  programs support this type.  ViewTek is one program
  96.                      that can be used to view these ANIM files.
  97.         '-a7l'       Create ANIM7 long-word file.  Largest and fastest
  98.                      type.
  99.         '-b'         Double buffer the display.
  100.         '-l'         Load the file into RAM before playing it.
  101.         '-m<mode>'   Specifies a mode to use.  If 'mode' begins with '0x'
  102.                      or '0X' then it is assumed to be the hexdecimal value
  103.                      of the display ID.  Otherwise it is assumed to be the
  104.                      name associated with the mode, e.g. "NTSC:Hires"
  105.                      under 2.0 or "NTSC:High Res" under 3.0.  This name
  106.                      must match one of the names in the display database.
  107.                      The mode given should be compatible with the display
  108.                      options, i.e. pick a HAM mode when '-h' is given
  109.                      and don't when it isn't.
  110.         '-d<delay>'  Changes the delay between each frame in 1/70's of
  111.                      a second.
  112.  
  113.    Files with palette changes may look messed up unless you use either the
  114. '-g' or '-c' option.  This is because of the conversion that takes place.
  115. There isn't really anything I can do about it.  Fortunately, these files
  116. are extremely rare.
  117.  
  118. Plans for the future:
  119.    A color option for non-AGA other than HAM.
  120.    Possibly a better HAM algorithm.
  121.    Some sort of GUI.  At least a file requester and a screen mode
  122.       requester.
  123.    Possibly a separate program to write FLI animations from IFF
  124.       pictures or ANIM's.
  125.  
  126.    If you want to see one of these features implemented then let me know!
  127.    Also, if you want to send me a faster chunky to planar routine, I'll
  128.         consider using it in the next version.
  129.  
  130. History:
  131.    v1.05   Initial release
  132.    v1.10   Fixed double buffering under 3.0 and a few other bugs.
  133.            Now tries appending '.FLI' and '.FLC' to find the file.
  134.            Calls BestModeID() under 3.0 to figure out the mode, so
  135.               super hires and other modes will be used if appropriate.
  136.               This made the old '-H' flag obsolete as hires HAM will
  137.               automatically be used.
  138.            Screen mode can be specified.  No screen requester yet, though.
  139.    v1.12   Fixed bug with uncompressed frames.
  140.    v2.01   Major improvements.  Faster playback, writing in modes
  141.               other than 256 color, writing ANIM files.  When writing
  142.               files, 256 color mode is no longer created by default.  The
  143.               '-c' flag is needed for this.
  144.    v2.02   Minor bug fixes.  Finally plays uncompressed correctly.  Also
  145.               fixed HAM mode when double buffering in fast mode.
  146.  
  147. I can be reached by e-mail at:
  148.  
  149. gmeeker@soda.berkeley.edu
  150.  
  151.